| Read Operations | Description |
|---|---|
|
Given a service name (PNT, UIS or CVS), this operation returns point attribute metadata information for the PNT service. |
Given a service name (PNT, UIS or CVS), this operation will return an XML response containing the point attribute metadata information for the specified point service. This operation is useful for exposing any “nice names” that have been assigned to specific point attributes. The return XML will also indicate success or failure.
The following table lists and describes all of the child elements of the request node (<GetPointAttrMetadataReq>).
| Element Name | Required | Description |
|---|---|---|
|
SvcName |
Yes |
The Site.Service to which to connect. This parameter must specify the name of a PNT, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated PNT. |
The service name node (<SvcName>) must specify the name of a PNT, UIS, or CVS Site.Service. If a UIS or CVS is specified, the service will resolve to its associated PNT.
|
<?xml version="1.0"?> <CygNetEnterpriseOperations xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721" > <GetPointAttrMetadataReq> <SvcName>CYGDEMO.PNT</SvcName> </GetPointAttrMetadataReq> </CygNetEnterpriseOperations> |
The following example represents a successful response.
|
<?xml version="1.0" encoding="UTF-8"?> <CygNetEnterpriseOperations xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects721"> <GetPointAttrMetadataResp> <PntAttrMetadata> <PointGeneral1>General 1 </PointGeneral1> <PointGeneral2>General 2</PointGeneral2> <PointIndexed1>Indexed 1</PointIndexed1> <PointIndexed2>Indexed 2</PointIndexed2> <PointIndexed3>Indexed 3</PointIndexed3> <PointTableDriven1>Table Driven 1</PointTableDriven1> <PointTableDriven2>Table Driven 2</PointTableDriven2> <PointTableDriven3>Table Driven 3</PointTableDriven3> <PointUserFlag1>User Flag 1</PointUserFlag1> <PointUserFlag2>User Flag 2</PointUserFlag2> <PointUserFlag3>User Flag 3</PointUserFlag3> <PointUserFlag4>User Flag 4</PointUserFlag4> <PointUserFlag5>User Flag 5</PointUserFlag5> <PointUserFlag6>User Flag 6</PointUserFlag6> <PointUserFlag7>User Flag 7</PointUserFlag7> <PointUserFlag8>User Flag 8</PointUserFlag8> <PointVerifiedFlag1>Verified Flag 1</PointVerifiedFlag1> <PointVerifiedFlag2>Verified Flag 2</PointVerifiedFlag2> <PointVerifiedFlag3>Verified Flag 3</PointVerifiedFlag3> <PointVerifiedFlag4>Verified Flag 4</PointVerifiedFlag4> </PntAttrMetadata> <OperationResults success="true" resp_timestamp="2011-10-05T21:48:10.189Z" exec_duration="PT8.091S"></OperationResults> </GetPointAttrMetadataResp> </CygNetEnterpriseOperations> |
The following example represents an unsuccessful response.
|
<?xml version="1.0" encoding="UTF-8"?> <CygNetEnterpriseOperations xmlns="https://CygNetSCADA.com/Schemas/CygNetEnterpriseObjects730"> <GetPointAttrMetadataResp> <PntAttrMetadata /> <OperationResults success="false" resp_timestamp="2011-07-30T22:13:02.517Z" exec_duration="PT0.002S"> <OperationResult type="ERROR" code="50003">Security check failed for ACS application ENTOPS and event ACCESS0</OperationResult> <OperationResult type="ERROR" code="50208">You are not permitted to execute this operation</OperationResult> </OperationResults> </GetPointAttrMetadataResp> </CygNetEnterpriseOperations> |